Project Debugger Settings

Before you can begin debugging a program you will need to select which symbolic debugger you use and provide details of the debug target and other information. The following section describes each of the debug settings in detail.

General Settings

The general category provides options that are required for basic debugger support. This section describes each field.

Symbolic Debugger

This drop-down determines the symbolic debugger that will be used. Depending upon the selection, the remaining fields in this tab will be active and the status of items in the Debug menu will change.

Program/Debug Target

This field specifies the target to be debugged. This is typically a program name although this may depend upon the selected debugger used.

Tip

Using the browse button to the right of the field will display the file dialog box. Selecting the debug target from here will automatically set both the Debug Target and Working Directory fields.

Program Arguments

This field determines the additional arguments that should be passed to the target program within the debugger. This should not be confused with arguments passed to the debugger itself.

Working Directory

This field determines the server profile and directory in which the debugger is executed. This is typically the location of the debug target but may be any valid directory location.

Prompt to Redirect Program Input/Output

This option prompts the user for a terminal identifier to which all debug target input and output is then subsequently redirected. This can be particularly useful when the program has complex I/O that may become confused with the debugger command line when allowed to run within the debug session tab in the output window.

Advanced

The advanced category specifies additional options for debugger execution. Only users familiar with the functionality of the target debugger should modify these settings.

Debugger Command Line

This field allows an advanced user to override the command that would normally be executed to start the host based debugger. This may be useful in circumstances where the debug command line requires a fully qualified location or requiring special options to be included.

The button to the right of the field provides a popup menu containing variables which may be used within the debugger command line, substituted for actual settings at run-time.

To

Use

Represent the program/debug target

$(DebugTarget)

Represent the arguments for the program/debug target

$(DebugTargetArgs)

In most cases the average user will probably not need to specify an alternate debugger command line.  However for those users who wish to, the option is there.

Debug Source Location

This field provides Programmer Studio with the location of files identified by the debugger when stepping into a debug target or when a break is reached in program execution (as a result of step over, step into or reaching a breakpoint). Most debuggers identify files using a fully qualified filename.  For those just displaying a filename, Programmer Studio requires a source directory to look in.

Execute Initial Debugger Commands

This field allows the user to enter any number of commands which should be executed from the debugger prompt prior to setting breakpoints and before the program is started within the debugger.

This can be very useful for setting debugger options which affect the execution of the program being debugged. These commands must not expect further input and must return the debugger to its normal input prompt after completion.